home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp95 / freyja_t.z / freyja_t / ftutoria.doc < prev    next >
Text File  |  1992-04-14  |  7KB  |  192 lines
  1.                Freyja Tutorial
  2.  
  3. This document will help you get started in learning how to use
  4. Freyja.  The best way to use it is to read it using Freyja.  You can
  5. do this by giving the command:
  6.  
  7.     freyja ftutoria.doc
  8.  
  9. You can also bring this document up by starting Freyja and typing:
  10.  
  11.     ^X ^F ftutoria.doc ^M (or Enter)
  12.  
  13. Most Freyja commands are given using the Control key.  This key is
  14. sometimes labelled Ctrl or Ctl.  This type of command will be written
  15. like this:
  16.  
  17.     ^#
  18.  
  19. where "#" is replaced by the letter that is typed along with control
  20. key.  For example, ^V for Control and the "V" key.  Now type the ^V
  21. command.
  22.  
  23.  
  24.  
  25. Good.  You are on the next screen.  The ^V command causes Freyja to
  26. move to the next screen of text.  Note that there is a little overlap
  27. between the screens.  From now on, just type this command whenever
  28. you finish reading a screen of text.
  29.  
  30. The natural next step is to learn how to move backwards by a screen. 
  31. There are two ways for you to indicate this action to Freyja.  The
  32. first is to give the ^Z command.  Try it, then use ^V to come back.
  33.  
  34. The ^Z command is specific to Freyja: other Emacs-type text editors
  35. do not use that command for this purpose.  Rather, the Emacs
  36. "standard" command for going back a screen is the ^[ V command.
  37.  
  38. This command looks a little funny.  The ^[ means the Control and [
  39. keys.  While you can type it this way, this command is also available
  40. on most keyboards as the Escape key (sometimes labelled Esc).  Thus,
  41. you give the ^[ V command by pressing AND RELEASING the Escape key,
  42. then pressing the V key (it doesn't matter whether you type an upper-
  43. or lower-case V).  Try it and come back here.  The commands that start
  44. with the Escape key (or are "prefixed" with the Escap key) are called
  45. "meta" commands.
  46.  
  47. On MS/DOS computers, Freyja treats Alt-shifted characters the same as
  48. their corresponding meta commands.  On these computers, Freyja also
  49. supports the arrow and function keys.  See the Freyja command list
  50. for details.
  51.  
  52. RECAP:
  53.  
  54.     ^V    moves forward one screen
  55.     ^Z    moves backward one screen
  56.     ^[ V    moves backward one screen
  57.     ^L    recenter the screen
  58.     ^[ ^L    completely rebuild the screen display from scratch
  59.  
  60.  
  61. Now that you can move by screens, how do you move in smaller amounts?
  62.  
  63.              ^P (*P*revious line)
  64.                 |
  65.                 |
  66. ^B (*B*ackward character) -----   ----- ^F (*F*orward character)
  67.                 |
  68.                 |
  69.                ^N (*N*ext line)
  70.  
  71. Freyja commands are more-or-less mnemonic: the letter associated with
  72. the command indicates what it does.  Thus, we have B for backward and
  73. F for forward.  Try these commands for a while.
  74.  
  75. You will notice when moving around that you can't move to anyplace
  76. that doesn't have text (for example, the blank lines between these
  77. paragraphs).  When going forward, you move from the end of a line to
  78. the start of the next line and vice-versa for moving backward.  When
  79. moving to the next or previous lines, the cursor "jumps" to the left
  80. edge of the screen then jumps back as you continue moving.
  81.  
  82. Note that if you should move off of the top or bottom of the screen,
  83. the display is shifted automatically to keep your current position
  84. visible.
  85.  
  86. You can move to the beginning or end of the line in one step by
  87. giving the ^A (beginning of line (well, B was taken)) and ^E (end of
  88. line) commands.  Note that if you keep giving the same commands, you
  89. don't keep moving.  Is this right?
  90.  
  91. RECAP:
  92.  
  93.     ^F    move forward by character
  94.     ^B    move backward by character
  95.     ^N    move to the next line
  96.     ^P    move to the previous line
  97.     ^A    move to the start of the line
  98.     ^E    move to the end of the line
  99.  
  100. The next step up from characters is words.  You will notice a pattern
  101. right off:
  102.  
  103.                ^[ A (start of sentence)
  104.                 |
  105.                 |
  106.    ^[ B (*B*ackward word) -----   ----- ^[ F (*F*orward word)
  107.                 |
  108.                 |
  109.                ^[ E (*E*nd of sentence)
  110.  
  111. Try these.  Note that when moving by words, you are always left at
  112. the "far end" of the word.  When moving by sentences, successive 
  113. ^[ A and ^[ E commands move to successive sentence.  This is a little
  114. different than the ^A and ^E commands.
  115.  
  116. We will finish off the moving-around commands with two other
  117. important ones:
  118.  
  119.     ^[ <    move to the beginning of the file
  120.     ^] >    move to the end of the file
  121.  
  122. Try all of the commands that you have learned so far (but try not to
  123. read ahead too much!).  Then come back here and keep going.
  124.  
  125.  
  126. MAKING CHANGES
  127.  
  128. If you want to add text to what is already there, it couldn't be
  129. easier.  Just:
  130.  
  131.     - move the cursor so that the *left edge* is at the place that
  132.     you want to add the text, and
  133.  
  134.     - type the new text (no Control-shifting or Escape-prefixing)
  135.  
  136. If you type a lot of text, you may notice that the end of the line
  137. "spills" off the right edge of the screen.  The text is still there,
  138. it just isn't visible.  If you want to see the text, just move there:
  139.  
  140.     - position the cursor to the line of interest
  141.     - give the ^E command (not yet...!)
  142.     - when done, give the ^A command to come back
  143.  
  144. Here is a long line to try it out on.  Now is the time for all good men to come to the aid of their country.
  145.  
  146. (You can also give the ^X > and ^X < commands to move the screen
  147. right and left.  But that is telling.)
  148.  
  149. So adding text is easy, how about deleting text?
  150.  
  151. You can delete text in many ways.  As many of these involve the ^H
  152. command, it is worth pointing out that this is also found as a "Back
  153. Space" or "BS" key (sometimes "Back Arrow") on many computers.  If
  154. your computer has a "Del" or "Delete" key, this also works (although
  155. it is a different character and written as ^?).
  156.  
  157. (This ^? character is typed on MS/DOS computers by Ctrl + Back Arrow.
  158. On these computers, the Ctrl + Back Arrow command is supposed to
  159. delete the entire previous word and Freyja does this.)
  160.  
  161. The basic deletion command are:
  162.  
  163.     ^H    delete back one character (analagous to ^B)
  164.     ^D    delete forward one character (analagous to ^F)
  165.  
  166.     ^[ ^H    delete back one word (analagous to ^[ B)
  167.     ^[ D    delete forward one word (analagous to ^[ F)
  168.  
  169. You can also delete by lines or sentences:
  170.  
  171.     ^K    delete to the end of the line; if at the end of the
  172.         line, delete just the line separator
  173.     ^[ K    delete forward one sentence (analagous to ^[ E)
  174.     ^X ^?    delete backard one sentence (analagous to ^[ A)
  175.  
  176. Try all of these (please be careful).  If you delete "too much," you
  177. can restore this file by giving the command:
  178.  
  179.     ^X ^R ^M (or Enter)
  180.  
  181. then answering "Y" to the question.
  182.  
  183. Those are the most often used commands.  At this point, the tutorial
  184. is over and you should go back to the "freyja.doc" file.  This file
  185. explains the rest of the concepts in Freyja.
  186.  
  187. We will finish by explaining one last useful command:
  188.  
  189.     ^X ^C
  190.  
  191. This command exits from Freyja.
  192.